/**
 * 辉瑞停车场预约系统API接口文档
 * 本文档列出所有需要的接口和数据格式
 */

/**
 * 1. 登录验证
 * 
 * 请求参数:
 * @param {string} phone - 手机号
 * 
 * 响应数据:
 * {
 *   success: true,
 *   userInfo: {
 *     phone: "13900000001",      // 手机号
 *     license: "沪A12345",       // 车牌号
 *     name: "张三",              // 用户姓名
 *     remainingQuota: 80,        // 剩余预约次数
 *     year: 2023                 // 当前年份
 *   }
 * }
 * 
 * 错误响应:
 * {
 *   success: false,
 *   message: "登录失败，该手机号未在系统中注册"
 * }
 */

/**
 * 2. 获取停车场可用车位数量
 * 
 * 请求参数:
 * @param {string} startDate - 起始日期字符串，格式为YYYY-MM-DD
 * 
 * 响应数据:
 * {
 *   success: true,
 *   startDate: "2023-05-01",
 *   data: [
 *     {
 *       date: "2023-05-01",       // 日期，格式YYYY-MM-DD
 *       weekday: 1,               // 星期几，0-6表示周日到周六
 *       availableSpots: 45        // 可用车位数量，null表示不可预约（周末或异常）
 *     },
 *     // ... 共40天的数据
 *   ]
 * }
 * 
 * 错误响应:
 * {
 *   success: false,
 *   message: "获取车位信息失败"
 * }
 */

/**
 * 3. 提交预约请求
 * 
 * 请求参数:
 * @param {Object} data - 预约数据
 * @param {string} data.phone - 手机号
 * @param {Array<string>} data.dates - 预约日期列表，格式为["YYYY-MM-DD", ...]
 * 
 * 响应数据:
 * {
 *   success: true,
 *   spotId: 42,                  // 车位ID
 *   spotName: "P-42",            // 车位名称
 *   message: "预约成功"
 * }
 * 
 * 错误响应:
 * {
 *   success: false,
 *   message: "预约失败，请稍后再试"
 * }
 */

/**
 * 4. 获取用户预约记录
 * 
 * 请求参数:
 * @param {string} phone - 手机号
 * 
 * 响应数据:
 * {
 *   success: true,
 *   reservations: [
 *     {
 *       id: "res123456",         // 预约ID
 *       date: "2023-05-10",      // 预约日期
 *       spotId: 42,              // 车位ID
 *       spotName: "P-42",        // 车位名称
 *       status: "active"         // 预约状态：active-有效，cancelled-已取消
 *     },
 *     // ... 更多预约记录
 *   ]
 * }
 * 
 * 错误响应:
 * {
 *   success: false,
 *   message: "获取预约记录失败"
 * }
 */

/**
 * 5. 取消预约
 * 
 * 请求参数:
 * @param {string} phone - 手机号
 * @param {string} date - 预约日期，格式为YYYY-MM-DD
 * @param {number} spotId - 车位ID
 * 
 * 响应数据:
 * {
 *   success: true,
 *   message: "取消成功"
 * }
 * 
 * 错误响应:
 * {
 *   success: false,
 *   message: "取消预约失败，请稍后再试"
 * }
 */

/**
 * 6. 获取系统配置
 * 
 * 请求参数: 无
 * 
 * 响应数据:
 * {
 *   success: true,
 *   config: {
 *     totalParkingSpots: 80,     // 总车位数
 *     yearlyQuota: 80,           // 年度预约配额
 *     quarterlyQuota: 20,        // 季度预约配额
 *     workdayDiscount: {         // 工作日折扣
 *       monday: 0.5,
 *       tuesday: 1,
 *       wednesday: 1,
 *       thursday: 1,
 *       friday: 0.5
 *     }
 *   }
 * }
 * 
 * 错误响应:
 * {
 *   success: false,
 *   message: "获取系统配置失败"
 * }
 */

/**
 * 7. 通过微信code获取手机号
 * 
 * 请求参数:
 * @param {string} code - 微信临时凭证
 * 
 * 响应数据:
 * {
 *   success: true,
 *   phoneNumber: "13912345678"   // 用户手机号
 * }
 * 
 * 错误响应:
 * {
 *   success: false,
 *   message: "获取手机号失败，请稍后再试"
 * }
 */